
# -------------------------- 1. 核心配置：字段映射字典（英文→中文，覆盖所有字段） --------------------------
# 键：集思录返回的英文字段名；值：中文列名+业务说明（说明可选，用于文档）
FIELD_MAPPING = {
    "main_update_time": {
        "cn_name": "数据更新时间",
        "desc": "本次数据获取的时间（YYYY-MM-DD HH:MM:SS）"
    },

    # 基础债券信息
    "bond_id": {
        "cn_name": "转债代码",
        "desc": "可转债的唯一标识代码（如123000）"
    },
    "bond_nm": {
        "cn_name": "转债名称",
        "desc": "可转债的简称（如“平安转债”）"
    },
    "price": {
        "cn_name": "转债现价",
        "desc": "可转债当前交易价格（单位：元）"
    },
    "increase_rt": {
        "cn_name": "转债涨跌幅",
        "desc": "可转债当日涨跌幅（单位：%）"
    },
    "bond_value": {
        "cn_name": "纯债价值",
        "desc": "需要计算"
    },
    "ytm_rt": {
        "cn_name": "贴现到期收益率(税前)",
        "desc": "持有至到期的年化收益率(税前,考虑贴现率)（单位：%）  "
    },


    "rating_cd": {
        "cn_name": "市场评级",
        "desc": "机构对可转债的信用评级（如AA+、AAA）"
    },
    "premium_rt": {
        "cn_name": "转股溢价率",
        "desc": "（转债价格-转股价值）/转股价值 ×100%（单位：%）"
    },
    "convert_price": {
        "cn_name": "转股价",
        "desc": "可转债转换为正股的每股价格（单位：元）"
    },
    "convert_value": {
        "cn_name": "转股价值",
        "desc": "可转债按当前正股价转换后的价值（单位：元）"
    },

    "dblow": {
        "cn_name": "双低",
        "desc": "是否符合双低标准（低溢价率+低转股价）"
    },


    "year_left": {
        "cn_name": "剩余年限",
        "desc": "可转债距离到期日的剩余时间（单位：年）"
    },

    "orig_iss_amt": {
        "cn_name": "原始发行量(亿元)",
        "desc": "原始发行量(亿元)"
    },
    "curr_iss_amt": {
        "cn_name": "剩余规模（亿元）",
        "desc": "剩余规模（亿元）"
    },
    "convert_amt_ratio": {
        "cn_name": "转股比例",
        "desc": "转股比例）"
    },

    "stock_nm": {
        "cn_name": "正股名称",
        "desc": "可转债对应的正股股票名称（如“平安银行”）"
    },
    "stock_id": {
        "cn_name": "正股代码",
        "desc": "可转债对应的正股股票代码（如000001）"
    },
    "sprice": {
        "cn_name": "正股价格",
        "desc": "正股当前交易价格（单位：元）"
    },
    "sincrease_rt": {
        "cn_name": "正股涨跌幅",
        "desc": "正股当日涨跌幅（单位：%）"
    },

    "pb": {
        "cn_name": "正股PB",
        "desc": "正股的市净率（Price-to-Book Ratio）"
    },





    "sw_cd": {
        "cn_name": "申万行业",
        "desc": "可转债对应正股的申万行业分类"
    },
    "market_cd": {
        "cn_name": "市场代码",
        "desc": "待描述"
    },
    "list_dt": {
        "cn_name": "上市日期",
        "desc": "可转债在交易所的上市交易日期"
    },



    "put_convert_price": {
        "cn_name": "回售触发价",
        "desc": "触发回售（投资者卖给发行人）的价格阈值（单位：元）"
    },
    "force_redeem_price": {
        "cn_name": "强赎触发价",
        "desc": "触发强制赎回的价格阈值（单位：元）"
    },


    "maturity_dt": {
        "cn_name": "到期日期",
        "desc": "可转债的到期兑付日期"
    },

    "volume": {
        "cn_name": "转债成交额(万元)",
        "desc": "成交额（万元）"
    },
    "svolume": {
        "cn_name": "正股成交额(万元)",
        "desc": "正股成交量（万元）"
    },
    "turnover_rt": {
        "cn_name": "换手率",
        "desc": "换手率"
    },

    "expire_rt": {
        "cn_name": "非贴现到期收益率(税前)",
        "desc": "持有至到期的年化收益率(税前,不考虑贴现率)（单位：%）  "
    },

    "option_value": {
        "cn_name": "期权价值(现值)",
        "desc": "期权价值(现值)"
    },

    "put_ytm_rt": {
        "cn_name": "回售收益率",
        "desc": "回售收益率"
    },











    "ref_yield_info": {
        "cn_name": "参考收益率",
        "desc": "参考收益率"
    },

    "btype": {
        "cn_name": "债券类型",
        "desc": "待描述"
    },
    "putting": {
        "cn_name": "回售中标记",
        "desc": "回售中标记(N未回售Y回售)"
    },
    "blocked": {
        "cn_name": "停牌标记",
        "desc": "停牌标记 0未停牌"
    },
    "convert_dt": {
        "cn_name": "转股起始日",
        "desc": "可转债开始允许转换为正股的日期"
    },






    "last_time": {
        "cn_name": "最后更新时间",
        "desc": "最后更新时间"
    },

    "qstatus": {
        "cn_name": "发行状态",
        "desc": "发行状态"
    },

    "adj_cnt": {
        "cn_name": "调整次数",
        "desc": "调整次数"
    },
    "adj_scnt": {
        "cn_name": "正股调整次数",
        "desc": "正股调整次数"
    },
    "convert_price_tips": {
        "cn_name": "转股价提示",
        "desc": "转股价提示"
    },
    "convert_cd_tip": {
        "cn_name": "转股代码提示",
        "desc": "转股代码提示"
    },

    "price_tips": {
        "cn_name": "价格提示",
        "desc": "价格提示"
    },


    "real_force_redeem_price": {
        "cn_name": "实际强赎价",
        "desc": "实际强赎价"
    },
    "after_next_put_dt": {
        "cn_name": "下一回售",
        "desc": "下一回售"
    },
    "is_min_price": {
        "cn_name": "最低价标记",
        "desc": "最低价标记"
    },
    "t_flag": {
        "cn_name": "T+0标记",
        "desc": "T+0标记"
    },
    "owned": {
        "cn_name": "持仓标记",
        "desc": "持仓标记"
    },
    "hold": {
        "cn_name": "持有数量",
        "desc": "持有数量"
    },
    "fund_rt": {
        "cn_name": "基金持仓比例",
        "desc": "基金持仓比例"
    },
    "noted": {
        "cn_name": "备注",
        "desc": "备注"
    },
    "sqflag": {
        "cn_name": "申购标记",
        "desc": "申购标记"
    },
    "pb_flag": {
        "cn_name": "PB标记",
        "desc": "PB标记"
    },
    "convert_price_valid": {
        "cn_name": "有效转股价",
        "desc": "有效转股价"
    },
    "adjusted": {
        "cn_name": "调整标记",
        "desc": "调整标记"
    },
    "option_tip": {
        "cn_name": "期权提示",
        "desc": "期权提示"
    },
    "force_redeem_price_tip": {
        "cn_name": "强赎价提示",
        "desc": "强赎价提示"
    },
    "notes": {
        "cn_name": "标记",
        "desc": "标记"
    },
    "bond_py": {
        "cn_name": "转债拼音",
        "desc": "转债名称的拼音（如“PINGANZZ”）"
    },

    "stock_py": {
        "cn_name": "正股拼音",
        "desc": "正股名称的拼音"
    },
    "icons": {
        "cn_name": "图标标记",
        "desc": "图标标记"
    },

    "redeem_dt": {
        "cn_name": "赎回日期",
        "desc": "赎回日期"
    },
    # 可根据你实际获取的字段，继续补充其他映射（如dblow、sw_cd等）
}
